home *** CD-ROM | disk | FTP | other *** search
/ Power CD / Power CD ATARI-Rechner Lieben.iso / UTILITY / NIU_082 / LIES_NIU.TXT next >
Encoding:
Text File  |  1993-11-22  |  8.7 KB  |  260 lines
  1. PROGRAMM
  2. ========
  3.  
  4. NEWDESK.INF-Utility  NIU.TTP  V0.82ß  23.11.1993
  5. Öffentliche Betaversion. Bitte Abschnitt `Wichtiger Hinweis' beachten!
  6.  
  7.  
  8.  
  9. KURZINFO
  10. ========
  11.  
  12. Mit dem NIU kann die NEWDESK.INF, welche vom Desktop ab TOS V2.0x angelegt
  13. wird, überprüft, korrigiert und interpretiert werden.
  14.  
  15.  
  16.  
  17. COPYRIGHT
  18. =========
  19.  
  20. Autor:     Dirk Hagedorn
  21. Anschrift: Platanenweg 36, D-33098 Paderborn
  22.  
  23. MausNet:   Dirk Hagedorn@PB
  24. MagicNet:  Seep@Paderbox
  25. ZNet:      D.Hagedorn@HSP
  26. InterNet:  dirk_hagedorn@pb.maus.de (privat, kein Binaries, keine UUe's!)
  27.  
  28.  
  29. NIU.TTP ist in der vorliegenden Version Freeware und darf somit auf
  30. beliebige Art und Weise an Dritte weitergegeben werden, solange folgende
  31. Voraussetzungen erfüllt sind:
  32.  
  33. - Für die Weitergabe (z.B. auf PD-Sammeldisketten) dürfen keine Gebühren
  34.   verlangt werden, die eine Höhe von 10 DM (exklusive Versandkosten)
  35.   überschreiten.
  36.  
  37. - Das Programm darf nur mit allen zugehörigen Dateien und in unveränderter
  38.   Form weitergegeben werden. Dies sind folgende Dateien:
  39.   - NIU.TTP       Das Programm selbst
  40.   - NIU.UPL       Kurzinformationen für den Upload in Mailboxen
  41.   - NEWDESK.TXT   Dokumentation der NEWDESK.INF
  42.   - LIES_NIU.TXT  Dieser Text, den Sie gerade lesen
  43.  
  44.  
  45.  
  46. BEZUGSQUELLEN
  47. =============
  48.  
  49. Die jeweils aktuelle Version des Programms ist beim Autor gegen Einsendung
  50. einer formatierten Diskette sowie eines frankierten und adressierten
  51. Rückumschlags erhältlich. Meine Anschrift finden Sie am Anfang dieses
  52. Texts.
  53.  
  54. Besitzer eines Modems finden die aktuelle Version dieses Programms in der
  55. Quark Paderborn im Brett ST-Tools sowie in der Maus Paderborn 2 im
  56. öffentlichen Programmteil als Archiv NIU_xxx.ZIP.
  57.  
  58. Quark PB: (05251) 71409  (freier Gastdownload)
  59. Maus PB2: (05251) 541578 (       - "" -      )
  60.  
  61.  
  62.  
  63. WICHTIGER HINWEIS
  64. =================
  65.  
  66. Dies ist eine öffentliche Betaversion. Daraus ergiebt sich, daß sich in
  67. diesem Programm noch Fehler befinden bzw. mit hoher Wahrscheinlichkeit
  68. noch Fehler enthalten sind.
  69.  
  70. Ich, Dirk Hagedorn, übernehme keine Haftung für irgendwelche direkten oder
  71. indirekten Schäden - einschließlich, aber nicht beschränkt auf -
  72. materielle oder finanzielle Schäden, die durch die Benutzung von 'NIU',
  73. oder die Untauglichkeit von 'NIU' für einen bestimmten Zweck, entstehen.
  74.  
  75.  
  76.  
  77. ÄNDERUNGEN
  78. ==========
  79.  
  80. 0.80ß: Erstveröffentlichung
  81. 0.81ß: interne Version
  82. 0.82ß: - NIU sollte nun nicht mehr beim Anlegen der korrigierten Fassung
  83.          abstürzen. Der Bug machte sich natürlich nur bei mir nicht
  84.          bemerkbar.
  85.        - maximale Zeilenanzahl auf 1024 erhöht (sollte reichen)
  86.        - erweiterte #E-Zeile wird nun ausgewertet
  87.        
  88.  
  89.  
  90. PROGRAMM-AUFRUF
  91. ===============
  92.  
  93. Starten Sie NIU genauso, wie Sie es von allen anderen TTP's her kennen:
  94. - vom Desktop durch Doppelklick auf die zugehörige Ikone und Eingabe der
  95.   Kommandozeilen-Parameter
  96. - durch Draggen einer Datei vom Typ `NEWDESK.INF' auf  die zugehörige
  97.   Ikone
  98. - durch Aufruf durch einen Kommandozeileninterpreter oder eine Shell.
  99.  
  100.  
  101. NIU erwartet eine Kommadozeile mit folgendem Aufbau:
  102.  
  103. [-cv] [-bhs] mask
  104.  
  105. Kommandos und Schalter werden durch einen vorangestellten Bindestrich
  106. gekennzeichnet.
  107.  
  108. `mask' steht für eine beliebige Dateimaske oder einen Dateinamen.
  109.  
  110. Werden keine Kommandos oder Schalter übergeben, so werden die gefundenen
  111. Dateien lediglich überpüft und das Ergebnis sowie die eventuell vorhandenen
  112. fehlerhaften Zeilen angezeigt.
  113.  
  114. Wird eine leere Kommandozeile ausgegeben, so gibt NIU lediglich ein paar
  115. Informationen über sich selbst aus.
  116.  
  117.  
  118. Kommandos:
  119.  
  120. -v: Eine Auswertung jeder Zeile der Datei wird ausgeben. Auf fehlerhafte
  121.     Zeilen wird besonders hingewiesen.
  122. -c: Fehlerhafte Zeilen werden - falls möglich - korrigiert oder entfernt.
  123.  
  124.  
  125. Schalter:
  126.  
  127. -b: Beim Sichern der korrigierten Datei wird KEIN Backup angelegt.
  128.     (Nur relevant, wenn -c benutzt wird)
  129. -h: Beim Programmende wird auf einen Tastendruck gewartet.
  130. -s: Single-Step-Modus beim Interpretieren der Zeilen. Nach jeder
  131.     Zeile der Newdesk.Inf-Datei wird auf einen Tastendruck gewartet.
  132.     (Nur relevant, wenn -v benutzt wird)
  133.  
  134.  
  135. Beispiele: -h c:\newdesk.inf
  136.            Die Datei C:\NEWDESK.INF wird lediglich überprüft und das
  137.            Ergebnis dieser Überprüfung ausgegeben. Danach wird auf einen
  138.            Tastendruck gewartet.
  139.  
  140.            -v c:\inf\*.*
  141.            Es wird eine ausführliche Beschreibung der Zeilen alle Dateien
  142.            aus dem Ordner C:\INF ausgegeben.
  143.  
  144.            -vhc c:\new*.*
  145.            -v -h -c c:\new*.*
  146.            Eine Interpretation aller gefundenen Dateien wird ausgegeben.
  147.            Fehlerhafte Zeilen werden korrigiert. Die Korrekturen werden
  148.            gesichert, wobei ein Backup der alten Datei angelegt wird.
  149.            Am Programmende wird noch auf einen Tastendruck gewartet.
  150.            
  151.            newdesk.inf
  152.            NIU überprüft lediglich die Datei NEWDESK.INF aus dem aktuellen
  153.            Ordner und gibt alle fehlerhaften Zeilen aus.
  154.  
  155. So, die Beispiele sollen auch genügen; wir sind hier ja schließlich nicht
  156. bei Jürgen von der Lippe's `Geld oder Liebe' ;-)
  157.  
  158.  
  159.  
  160. ÜBERPRÜFUNG
  161. ===========
  162.  
  163. NIU überprüft derzeit die Zeilen einer NEWDESK.INF folgendermaßen:
  164.  
  165. - In einigen Zeilen stehen Zugriffspfade und/oder Dateinamen. NIU prüft,
  166.   ob diese vorhanden sind.
  167. - In einigen Zeilen ist die Position einer Ikone vermerkt. NIU prüft,
  168.   ob auf diese Position bereits eine andere Ikone liegt. Somit können
  169.   Doppelbelegungen erkannt werden. Mir ist das übrigens bereits schonmal
  170.   passiert, man mag es kaum glauben ;-)
  171. - In einigen Zeilen ist der Text zu einer Ikone angegeben. NIU prüft,
  172.   ob dieser nicht länger als 13 Zeichen ist, welches die maximale vom
  173.   Desktop darstellbare Länge ist. Der Desktop scheint längere Ikonentexte
  174.   übrigens zu tolerieren.
  175. - NIU prüft bei angemeldeten Anwendungen, ob die Länge der zu
  176.   übergebenden Parameter kleiner oder gleich 11 ist und ob der Dateityp
  177.   aus maximal 3 Zeichen (ohne *.) besteht. Der Dialog `Anwendung anmelden'
  178.   des Desktops kommt im Fehlerfalle gehörig ins Schleudern.
  179. - Die #d-Zeile muß exakt 47 Zeichen lang sein. Ist sie es nicht, so wird
  180.   ein Hinweis darauf ausgegeben.
  181. - Die #M-Zeile enthält die Kennung des zugehörigen Laufwerks. NIU prüft,
  182.   ob diese zulässig ist, also A, B, ..., Z oder c (ROM-Modul) lautet.
  183.  
  184. Anmerkung: Wird keine Interpretation der Zeilen ausgegeben, so werden im
  185.            Falle des Vorhandenseins von fehlerhaften Zeilen nur diese
  186.            ausgegeben.
  187.  
  188.  
  189.  
  190. INTERPRETATION
  191. ==============
  192.  
  193. Wird beim Start von NIU das Kommando -v übergeben, so wird die Bedeutung
  194. jeder einzelnen Zeile ermittelt und ausgegeben.
  195.  
  196. Bei einigen Zeilen bin ich mir jedoch nicht ganz im Klaren, ob NIU die
  197. korrekten Werte ausgibt, da mir lediglich die Dokumentation zur alten
  198. DESKTOP.INF aus dem ST-Profibuch (7. Auflage) zur Verfügung stand und
  199. ich mir den Rest per Trial&Error selbst ermittelt habe.
  200.  
  201. Keine Garantie kann ich für die Richtigkeit der Interpretation folgender
  202. Zeilen geben: #c, #E, #Q, #S.
  203.  
  204.  
  205.  
  206. KORREKTUR
  207. =========
  208.  
  209. Eine Datei wird automatisch korrigiert, wenn das Kommando -c übergeben
  210. wurde. Findet NIU eine fehlerhafte Zeile, so wird diese (falls möglich)
  211. korrigiert oder entfernt. NIU legt dann ein Backup der alten Datei an 
  212. (wenn der Schalter -b nicht gesetzt ist) und sichert eine korrigierte
  213. Fassung der jeweiligen Datei.
  214.  
  215. NIU bearbeitet eine Datei folgendermaßen:
  216.  
  217. - Zeilen mit nichtgefundenen Ordnern und Dateien werden rigoros entfernt.
  218. - Sonstige Fehler werden korrigiert, d.h. eine neue Zeile wird aus den
  219.   richtigen und korrigierten Werten der alten Zeile erstellt.
  220.   Dies betrifft momentan: - überlange Ikonentexte
  221.                           - überlange Dateitypen
  222.                           - überlange Parameter
  223.                           - falsche Funktionstastenwerte
  224. - Ist die #d-Zeile nicht 47 Zeichen lang, so wird sie auf diese Länge
  225.   gebracht.
  226. - Keine Korrektur wird bei einer Doppelbelegung einer Ikonenposition
  227.   vorgenommen.
  228.   
  229.  
  230.  
  231. EIN TIP
  232. =======
  233.  
  234. Gerade beim Interpretieren bekommt man kaum mit, was NIU denn nun so
  235. alles ausgibt. In einer der nächsten Versionen von NIU wird es
  236. möglich sein, alle Ausgaben in einer Datei zu protokollieren.
  237.  
  238. Derzeit kann ich lediglich darauf hinweisen, daß man die Ausgabe von
  239. NIU (und jedem anderen TOS/TTP-Programm) mit Control+S anhalten und
  240. mit Control+Q fortführen kann.
  241.   
  242. Benutzer einer Shell sind daher klar im Vorteil, da sie die Ausgaben
  243. von NIU jederzeit in eine Datei umlenken können.
  244.  
  245.  
  246.  
  247. INTERNA
  248. =======
  249.  
  250. - erstellt mit Pure Pascal V1.1 vom 30. Juni 1993
  251. - maximale Dateianzahl: 128
  252. - maximale Dateigröße:  1024 Zeilen
  253. - maximale Zeilenlänge: 255 Zeichen
  254.  
  255.  
  256.  
  257. Viel Spaß mit NIU,
  258.  
  259. Dirk Hagedorn, 23. November 1993
  260.